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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.361: "Entry Point (EP) Integration Reference Point (IRP): Requirements"; 

32.362: "Entry Point (EP) Integration Reference Point (IRP): Information Service (IS)"; 

32.363: "Entry Point (EP) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORE A) Solution Set (SS)"; 

32.365: "Entry Point (EP) Integration Reference Point (IRP): extensible Markup Language (XML) 

definitions". 

32.367: "Entry Point (EP) Integration Reference Point (IRP): SOAP Solution Set (SS)". 
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Scope 



The present document specifies the SOAP Solution Set for the IRP whose semantics are specified in Entry Point IRP: 
Information Service (3GPP TS 32.362 [4]). 

This Solution Set specification is related to 3GPP TS 32.362 V8.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.361: " Technical Specification Group Services and System Aspects; 

Telecommunication management; Entry Point (EP) Integration Reference Point (IRP): 
Requirements ". 

[4] 3GPP TS 32.362: " Technical Specification Group Services and System Aspects; 

Telecommunication management; Entry Point (EP) Integration Reference Point (IRP): Information 
Service (IS)". 

[5] 3GPP TS 32.365: " Telecommunication management; Entry Point (EP) Integration Reference 

Point (IRP): extensible Markup Language (XML) definitions". 

[6] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[8] 3GPP TS 32.317: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; SOAP solution set". 

[9] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[10] 3GPP TS 32.307: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): SOAP solution set". 

[II] W3C SOAP 1 . 1 specification (http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 
[12] W3C XPath 1.0 specification (http://www.w3.org/TR/1999/REC-xpath-19991 1 16 ) 
[13] W3C WSDL 1.1 specification ( http://www.w3 .org/TR/200 l/NOTE-wsdl-200 1 03 1 5) 
[14] W3C SOAP 1 .2 specification (http://www.w3 .org/TR/soap 1 2-part 1/) 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.150 [9] and 3GPP TS 32.361 [3] and the following apply: 

IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [6]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

IS Information Service 

SS Solution Set 

WSDL Web Service Description Language 



Architectural features 



4.1 General 

The overall architectural feature of the Entry Point IRP is specified in 3GPP TS 32.362 [4]. This clause specifies 
features that are specific to the SOAP solution set. 

The SOAP 1.1 specification [11] and WSDL 1.1 specification [13] are supported. 

The SOAP 1.2 specification [14] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [12]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

The Entry Point IRP SOAP SS uses the Notification IRP SOAP SS of 3GPP TS 32.307 [10]. The IRP Agent shall 
support the push interface model, which means that the IRP Agent sends Entry Point notifications to the IRPManager as 
soon as new events occur. The IRPManager does not need to check ("pull") for events. 

This specification uses a number of namespace prefixes throughout that are listed in Table 4.1. 
Table 4.1 : Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


entryPointlRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.367#EntryPointlRPSystem 


entryPointlRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/32. 367#EntryPointlRPData 


xn 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 625#genericNrm 


genericlRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.31 7/schema/3231 7-81 0/GenericlRPSystem 


genericlRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.31 7/schema/3231 7-81 0/GenericlRPData 


ntflRPNtfSystem 


http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307- 
810/notification/NotificationlRPNtfSystem 



The WSDL structure is depicted in Figure 4.1 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 
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Figure 4.1 : Entry Point IRP SOAP Solution Set WSDL structure 



5 Mapping 

5.1 Operation and notification mapping 

The Entry Point IRP IS (3GPP TS 32.362 [4]) defines the operations and their semantics. 

Table 5.1 maps the operations defined in the Entry Point IRP IS to their equivalent types, messages, port type operation, 
and binding operation in this Solution Set (SS). 

Table 5.1 also maps the notifications of the Entry Point IRP IS, as well as inherited operations. 

Table 5.1 also qualifies if an operation is Mandatory (M) or Optional (O). 

Table 5.1 : Mapping from IS Operation to SS Equivalents 



IS Operation in 3GPP TS 32.362 [4] 


SS: Operation for WSDL port 
type and WSDL binding 


SS: Port of 
EntryPointlRPService 


Qualifier 


getlRPOutiine 


getlRPOutiine (note 1) 


EntryPointlRPPort 


M 


getlRPReference 


getlRPReference (note 1) 


EntryPointlRPPort 


M 


releaselRPReference 


releaselRPReference (note 1) 


EntryPointlRPPort 


M 


notifylRPInfoChanges 


notify (note 2) 


NotificationlRPNtfPort 


M 


getlRPVersion (note 3) 


See TS 32.317 [8] 


GenericIRPPort 


M 


getOperationProfile (note 3) 


See TS 32.317 [8] 


GenericIRPPort 





getNotificationProfile (note 3) 


See TS 32.317 [8] 


GenericIRPPort 





NOTE 1 : The operation is under the port type entryPointlRPSystem:EntryPointlRPPortType and under the 
binding entryPointlRPSystem:EntryPointlRPBinding. 


NOTE 2: The IS equivalent maps to an XML definition specified in 3GPP TS 32.365 [5], and this being an input 
parameter to the operation notify under the port type ntflRPNtfSystem:NotificationlRPNtf and under the 
binding ntflRPNtfSystem:NotificationlRPNtf of 3GPP TS 32.307 [10]. This binding is linked to a port of 
the EntryPointlRPService as indicated in the table above. 


NOTE 3: The IS operation is inherited from the IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. 

This inheritance is by the EPIRP IOC of 3GPP TS 32.362 [4] inheriting from the ManagedGenericIRP 
IOC. The corresponding binding is linked to a port of the EntryPointlRPService as indicated in the table 
above. 



5.2 Operation parameter mapping 



The Entry Point IRP IS (3GPP TS 32.362 [4]) defines semantics of parameters carried in the operations. The tables 
below show the mapping of these parameters, as per operation, to their equivalents defined in this SS. 
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5.2.1 .1 Input parameters 

Table 5.2.1.1 : Mapping from IS getiRPOutllne input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


iRPVersion 


iRPVersion 


M 



5.2.1.2 Output parameters 

Table 5.2.1.2: Mapping from IS getiRPOutline output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


supportedlRPList 


supportedlRPList 


M 


status 


status 


M 



5.2.1.3 



Fault definition 
Table 5.2.1.3: Mapping from IS getiRPOutllne exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


invalidlRPVersion 


InvalidlRPVersion 


M 


operationFailed 


OperationFailed 


M 



5.2.2 Operation getlRPRef erence 

5.2.1 .1 Input parameters 

Table 5.2.1.1 : Mapping from IS getiRPReference input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


managerldentifier 


managerldentifier 


M 


system DN 


system DN 


M 


rDN 


rDN 


M 
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5.2.1.2 



Output parameters 



Table 5.2.1.2: Mapping from IS getiRPReference output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


iRPReference 


iRPReference 


M 


status 


status 


M 



5.2.1.3 Fault definition 

Table 5.2.1.3: Mapping from IS getiRPReference exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


invalidRequestedParameters 


InvalidRequestedParameters 


M 


operationFailed 


OperationFailed 


M 



5.2.3 Operation releaselRPRef erence 

5.2.1 .1 Input parameters 

Table 5.2.1.1: Mapping from IS releaseiRPRef erence input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


managerldentifier 


managerldentifier 


M 


iRPReference 


iRPReference 


M 



5.2.1 .2 Output parameters 

Table 5.2.1.2: Mapping from IS releaseiRPRef erence output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


status 


status 


M 



5.2.1.3 



Fault definition 
Table 5.2.1.3: Mapping from IS releaseiRPRef erence exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


unknown 1 RPReference 


UnknownlRPReference 


M 


operationFailed 


OperationFailed 


M 
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Annex A (normative): 
WSDL specifications 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.367 Entry Point IRP SOAP Solution Set 
- - > 

<def initions xmlns="http : //schemas .xmlsoap .org/wsdl/" 
xmlns : soap="http : //schemas .xmlsoap .org/wsdl /soap/" 

xmlns : entryPointIRPSystem="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 3 6 7#EntryPointIRPSyste 
m" 

xmlns : entryPointIRPData="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 3 6 7#EntryPointIRPData" 
xmlns :xn="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 62 5#genericNrm" 

xmlns :genericIRPSystem="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 17/ schema/ 32 317 - 
810/GenericIRPSystem" 

xmlns :genericIRPData="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 17/ schema/ 32 317 - 
810/GenericIRPData" 

xmlns :ntf IRPNtfSystem="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 3 07/schema/323 07- 
810/notification/NotificationIRPNtf System" 
targetName space ="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 6 7#EntryPointIRPSystem" > 

< import name space ="http : //www. 3gpp . org/f tp/Specs/archive/32_series/ 32 . 3 07/schema/323 07- 
8 00/not if icat ion/Not if icationlRPNtf System" 
location="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 7/ schema/323 07 -8 10 -wsdl . zip"/> 

< import namespace="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
800/GenericIRPSystem" location="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 17/ schema/ 32 317- 
810-wsdl . zip"/> 
<types> 

< schema 
targetNamespace="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 6 7#EntryPointIRPData" 
xmlns="http: //www.w3 . org/2 1/XMLSchema " > 

< import name space ="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 . 62 5#genericNrm"/> 
< import name space ="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 3 17/ schema/ 32 317 - 
810/GenericIRPData"/> 

<!-- The following types are defined for the Entry Point IRP operations --> 
<simpleType name="OperationStatusTwo" > 
<restriction base="string" > 

< enumeration value="OperationSucceeded"/> 
< enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 

<complexType name="IRPManagement Scope" > 
<sequence> 

<element name="subTreeDN" type="xn:dn" minOccurs="0" maxOccurs="unbounded"/> 
</sequence> 
</complexType> 

<complexType name="IRPElement" > 
<sequence> 

<element name="rDN" type="xn:dn"/> 

< element name="iRPVersionSet" type="genericIRPData :VersionNumberSetType"/> 
< element name="iRPManagement Scope" type="entryPointIRPData : IRPManagement Scope" 
minOccur s = " " / > 

</sequence> 
</complexType> 

<complexType name="IRPList" > 
<sequence> 

<element name="iRPElement" type="entryPointIRPData : IRPElement" 
maxOccur s = " unbounded " / > 

</sequence> 
</complexType> 

<complexType name="SupportedIRP" > 
<sequence> 

<element ref ="xn: systemDN"/> 

<element name="iRPList" type="entryPointIRPData : IRPList"/> 
</sequence> 
</complexType> 

<complexType name="SupportedIRPList" > 
<sequence> 

< element name=" support edIRP" type="entryPointIRPData : Support edIRP" 
maxOccur s = " unbounded " / > 

</sequence> 
</complexType> 

<!-- getlRPOutline Request- -> 
<element name="getIRPOutline" > 
< c omp 1 exTyp e > 
<sequence> 

< element name="iRPVersion" type="genericIRPData : VersionNumberType"/> 
</sequence> 
</complexType> 
</element> 

<!-- getlRPOutline Response --> 
<element name="getIRPOutlineResponse" > 
< c omp 1 exTyp e > 
<sequence> 
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< element name="supportedIRPList" type="entryPointIRPData : SupportedIRPList"/> 
< element name=" status" type="entryPointIRPData : Operations tatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- getlRPOutline Fault --> 
<element name="getIRPOutlineFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="InvalidIRPVersion"/> 
< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 
</element> 

<!-- getlRPRef erence Request --> 
<element name="getIRPRef erence" > 
<complexType> 
<sequence> 

<element name="managerldentif ier" type="xn:dn"/> 
<element ref ="xn: systemDN"/> 
<element name="rDN" type="xn:dn"/> 
</sequence> 
</complexType> 
</element> 

<!-- getlRPRef erence Response --> 
<element name="getIRPRef erenceResponse" > 
<complexType> 
<sequence> 

<element name="iRPRef erence" type="xn:dn"/> 

< element name=" status" type="entryPointIRPData : Operations tatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- getlRPRef erence Fault --> 
<element name="getIRPRef erenceFault" > 
<simpleType> 

<restriction base="string" > 

<enumeration value="InvalidRequestedParameters"/> 
< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 
</element> 

<!-- releaselRPRef erence Request --> 
<element name="releaseIRPRef erence "> 
< c omp 1 exTyp e > 
<sequence> 

<element name="managerldentif ier" type="xn:dn"/> 
<element name="iRPRef erence" type="xn:dn"/> 
</sequence> 
</complexType> 
</element> 

<!-- releaselRPRef erence Response --> 
<element name="releaseIRPRef erenceResponse" > 
< c omp 1 exTyp e > 
<sequence> 

< element name=" status" type="entryPointIRPData : Operations tatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- releaselRPRef erence Fault --> 
<element name="releaseIRPRef erenceFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="UnknownIRPRef erence" /> 
< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="getIRPOutline" > 

<part name= "parameter" element ="entryPointIRPDat a : getlRPOutline" /> 
</message> 
<message name="getIRPOutlineResponse" > 

<part name= "parameter" element ="entryPointIRPDat a :getIRPOutlineResponse"/> 
</message> 
<message name="getIRPOutlineFault" > 

<part name= "parameter" element="entryPointIRPData :getIRPOutlineFault"/> 
</message> 
<message name="getIRPRef erence" > 

<part name= "parameter" element="entryPointIRPData : getlRPRef erence" /> 
</message> 
<message name="getIRPRef erenceResponse" > 

<part name= "parameter" element ="entryPointIRPDat a igetlRPRef erenceResponse" /> 
</message> 
<message name="getIRPRef erenceFault" > 

<part name= "parameter" element="entryPointIRPData : getlRPRef erenceFault "/> 
</message> 
<message name="releaseIRPRef erence" > 
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<part name= "parameter" element ="entryPointIRPDat a : releaselRPRef erence"/> 
</message> 
<message name="releaseIRPRef erenceResponse" > 

<part name= "parameter" element ="entryPointIRPDat a : releaselRPRef erenceResponse "/> 
</message> 
<message name= " releaselRPRef erenceFault" > 

<part name= "parameter" element="entryPointIRPData : releaselRPRef erenceFault "/> 
</message> 

<portType name="EntryPointIRPPortType" > 
<operation name="getIRPOutline" > 

< input message="entryPointIRPSystem:getIRPOutline"/> 
<output message="entryPointIRPSystem:getIRPOutlineResponse"/> 

< fault name="getIRPOutlineFault" message="entryPointIRPSystem:getIRPOutlineFault"/> 
</operation> 
<operation name="getIRPRef erence" > 

< input me s sage = "entryPointIRPSyst em: getlRPRef erence" /> 
<output me s sage ="entryPointIRPSyst em: getlRPRef erenceResponse "/> 

< fault name=" getlRPRef erenceFault" message="entryPoint IRPSystem: getlRPRef erenceFault "/> 
</operation> 
<operation name=" releaselRPRef erence" > 

< input me s sage ="entryPoint IRPSystem: releaselRPRef erence" /> 
<output me s sage ="entryPoint IRPSystem: releaselRPRef erenceResponse "/> 
< fault name=" releaselRPRef erenceFault" 
me s sage ="entryPoint IRPSystem: releaselRPRef erenceFault "/> 
</operation> 
</portType> 

<binding name="EntryPointIRPBinding" type="entryPointIRPSystem: EntryPointlRPPortType" > 
<soap : binding style=" document" transport ="http : //schemas .xmlsoap . org/soap/http"/> 
<operation name="getIRPOutline" > 
<soap : operation 
soapAction="http : //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 3 6 7#getIRPOutline" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name="getIRPOutlineFault" > 

<soap:fault name="getIRPOutlineFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="getIRPRef erence" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 3 6 7#getIRPRef erence" 
style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name = "getIRPRef erenceFault" > 

<soap:fault name="getIRPRef erenceFault" use="literal"/> 
</fault> 
</operation> 

<operation name=" releaselRPRef erence" > 
<soap : operation 
soapAction="http : //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 3 6 7#re lease IRPRef erence" 
style= "document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name=" releaselRPRef erenceFault" > 

<soap:fault name=" releaselRPRef erenceFault" use="literal"/> 
</fault> 
</operation> 
</binding> 
<service name="EntryPointIRPService" > 

<port name="EntryPointIRPPort" binding="entryPointIRPSystem: EntryPointlRPBinding" > 
<soap : address 
location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/ 32 . 367#EntryPointIRP"/> 
</port> 

<port name=" Generic IRPPort" binding="genericIRPSystem:GenericIRPBinding" > 
<soap : address 
location="http : //www. 3gpp .org/f tp/Specs/archive/32_series/ 32 . 317#GenericIRP"/> 
</port> 

<port name="Notif icationlRPNtf Port" binding="ntf IRPNtf System:Notif icationlRPNtf " > 
<soap : address 
location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/ 32 . 307#Notif icationlRPNtf "/> 
</port> 
</service> 
</def initions> 
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Annex B (informative): 
WSDL electronic files 



The electronic files corresponding to the normative WSDL/XML schema defined in the present document are available 
in native form in the following archive: 

http://www.3gpp.org/ftp/Specs/archive/32_series/32.367/schema/32367-800-wsdl.zip 
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